The Blocks consist of a short description, a long description and phpDoc tags. phpDoc blocks also serve as the input for phpDocumentor and/or the IDE's structured descriptions that are shown attached to Code Assist.
Note: If you wish to add a comment to the code but do not want the comment to be visible in the API documentation use standard comments /*.